home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: Alpha / Whiteline Alpha.iso / progtool / gfabasic / gfashell / readme.txt < prev   
Encoding:
Text File  |  1994-09-22  |  12.7 KB  |  376 lines
  1.  
  2.                            GFASHELL.PRG V.1.0 
  3.                            ================== 
  4.  
  5.                         Version vom 18-SEP-1989 
  6.  
  7.  
  8.                                 VORWORT: 
  9.                                 ======== 
  10.  
  11. Nach langem warten war der Compiler für das GFA-Basic Version 3.0 nun 
  12. endlich erschienen. Mit zittrigen Händen wurde der Umschlag geöffnet und 
  13. die darinliegende Diskette in die Floppy geschoben. Doch was ist das? 
  14. Nach dem Start  von GFA_BCOM.PRG passierte nicht das was man bisher vom 
  15. GFA-Compiler (V.2) gewöhnt war. Also half nichts, das Handbuch mußte 
  16. doch noch aufgeschlagen werden. (Wer liest denn noch Handbücher?) Aha, 
  17. MENUX.PRG muß gestartet werden, wär hätte das gedacht. Parameter gehören 
  18. auch noch dazu. Was bedeutet nun schon wieder S> in der Parameterliste, 
  19. wo ist denn schon wieder das Handbuch hin? HILFE wo bleibt die bisher 
  20. gewohnte Arbeitsumgebung?!! 
  21.  
  22. Es half nichts. Was ein richtiger Programmierer ist, der macht sich halt 
  23. seine Arbeitsumgebung selbst. So entstand also in schweißtreibenden 
  24. Nächten die GFASHELL.
  25.   
  26. Sinn dieses Programmes ist es also die Arbeit mit GFA-Basic 3.0 zu 
  27. vereinfachen, und wo ich gerade dabei war kamen dann noch ein paar 
  28. kleine Extras dazu. Das Programm ist weitgehend selbsterklärend 
  29. geschrieben, aber trotzdem  folgt hier eine kleine Beschreibung:
  30.  
  31.  
  32.                           BEDIENUNGSANLEITUNG: 
  33.                           ====================
  34.  
  35.               (Wenn sie jemals von irgendwem gelesen wird) 
  36.  
  37.  
  38. Zu dem Programm gehören die Dateien: 
  39.  
  40. GFASHELL.PRG (Das eigentliche Programm) 
  41. GFASHELL.RSC (Die dazugehörende Resource-Datei) 
  42. GFASHELL.INF (Datei mit Defaultwerten für die SHELL) 
  43. README.TXT (Diese Datei lesen Sie gerade) 
  44. README.DOC (Dasselbe in WORDPLUS-Format) 
  45.  
  46. Die ersten drei Dateien müssen im selben Ordner liegen (z.B.: GFA_3). 
  47.  
  48. Die Mindestkonfiguration ist ein Speicherplatz von mindestens 520 K, ein 
  49. einseitiges Laufwerk sowie ein SM124 Monitor (Real Programers don't use 
  50. color!). Eine Festplatte oder eine RAMDISK erhöhen die Geschwindigkeit. 
  51. Ein Drucker ist natürlich immer empfehlenswert. 
  52.  
  53.  
  54.                            1. Programmstart:
  55.                            =================  
  56.  
  57. Bevor Sie das Programm starten, sollten Sie überprüfen, ob die Angaben 
  58. in GFASHELL.INF Ihrer Arbeitsumgebung entspricht.
  59. Die Originaldatei sieht wie folgt aus: 
  60.  
  61.  
  62.     '
  63.     ' INFO-FILE FUER GFAASHELL
  64.     ' ************************
  65.     '
  66.     ' STANDARTNAMEN FUER COMPILE UND LINK
  67.     '
  68.     G3OBJ=F:\GFA_3\TEST.O
  69.     G3PRG=F:\GFA_3_TEST.PRG
  70.     '
  71.     ' PROGRAMME DIE VON GFASHELL DIREKT AUSGEFUEHRT WERDEN
  72.     '
  73.     G3LIB=F:\GFA_3\GFA3BLIB
  74.     G3INT=F:\GFA_3\GFABASIC.PRG
  75.     G3COM=F:\GFA_3\GFA_BCOM.PRG
  76.     G3LNK=F:\GFA_3\GL.PRG
  77.     G3RCS=F:\GFA_3\RCS2.PRG
  78.     '
  79.     ' KANN BEI BEDARF GESETZT WERDEN:
  80.     '
  81.     ' SHELL=
  82.     '
  83.     ' STANDARTPFAD FÜR FILESELECTORBOX
  84.     '
  85.     G3PTH=F:\GFA_3\MAKE\
  86.  
  87. Kommentarzeilen werden mit ',! oder ; gekennzeichnet. Am Anfang und am 
  88. Ende jeder Zeile können beliebig viele Blanks stehen. Die Reihenfolge 
  89. der Definitionen kann frei gewählt werden. Sollten Parameter nicht 
  90. definiert sein, werden automatisch die Defaultwerte aus dem Handbuch 
  91. genommen.
  92.  
  93.  
  94.  
  95.                                 2. INFOS
  96.                                 ========
  97.  
  98. Sie haben das Programm schon gestartet? Dann haben Sie ja schon gesehen 
  99. wie sich das ganze auf dem Bildschirm darstellt.
  100.  
  101. Der weiße Kasten oben beinhaltet die sehr wichtige Mitteilung wie das 
  102. Programm heiβt, und von wem es erstellt wurde. Wenn Sie diese BOX 
  103. anklicken erscheint ein biβchen Werbung für mich. Sie haben nun die 
  104. Möglichkeit mit "ZURUECK" wieder in die SHELL zurückzukehren, oder sich 
  105. mit "PARAMETER" alle aktuellen Werte der SHELL anzeigen zu lassen. Wenn 
  106. Sie sich sattgesehen haben genügt ein Mausklick und Sie sind wieder in 
  107. der SHELL.  
  108.  
  109.  
  110.                               3. Arbeiten
  111.                               ===========
  112.  
  113. Der Kasten unter den Informationen ist für die Definitionen der 
  114. Standard-Datei-Namen und zum Aufruf der GFA-Programme gedacht:
  115.  
  116. EDIT     Aufruf des GFA-Basic-Interpreters
  117. COMPILE  Aufruf des GFA-Basic-Compilers
  118. LINK     Aufruf des GFA-Basic-Linkers
  119. MAKE     Aufruf des Compilers, und des Linkers hintereinander
  120. RCS      Aufruf des Resource-Construktion-Sets
  121. TEST     Aufruf des zuletzt compilierten Programmes
  122.  
  123. GFA      Bestimmung des *.GFA Files
  124. OBJ      Bestimmung des Objekt-Files
  125. PRG      Bestimmung des Programm-Files
  126. LIB      Bestimmung der Library
  127. C-OBJ    Bestimmung des C-Objekt-Files das dazugelinkt werden soll
  128.  
  129. OBJ=GFA  Objektfile nimmt automatisch den Namen des GFA-Files an.
  130. PRG=GFA  Programmfile nimmt automatisch den Namen des GFA-Files an.
  131.          (Wenn hat es nicht schon gestört, daß alle Programme TEST.* 
  132.          genannt werden?)
  133. G3WAIT   G3WAIT ein oder ausschalten (s. Handbuch)
  134. G3MOVE   G3MOVE ein oder ausschalten (s. Handbuch)
  135. COMMAND  Ruft einen COMMAND-LINE-INTERPRETER auf. Standardmäβig wird eine
  136.          abgespeckte auf die SHELL angepaβte Version des LCI's benutzt.
  137.          Wenn in GFASHELL.INF eine andere SHELL benannt ist wird 
  138.          natürlich diese benutzt. (Man kann natürlich auch ein normales 
  139.          Programm definieren, und dann z.B. Raumschiffe abballern, 
  140.          Malen, Briefe schreiben o.Ä.)
  141.  
  142. EXIT     Alles auf dieser Erde ist vergänglich, so auch die GFASHELL.
  143.  
  144.  
  145.                               4. Parameter
  146.                               ============
  147.  
  148. Die Bedienung der Parametereinstellung entspricht in etwa der Bedienung 
  149. von MENU.PRG bzw. MENUX.PRG, nur ist alles auf einen Blick, im Klartext 
  150. ohne ständiges nachschlagen im Handbuch sichtbar. Die genaue Bedeutung 
  151. der Parameter ist recht ausführlich im Handbuch beschrieben. Leute die 
  152. ihren Compiler "zufällig" auf einer ihrer Disketten entdeckt haben, 
  153. sollten sich vielleicht doch noch den Compiler kaufen. Ich verrate hier 
  154. nichts.
  155.  
  156.  
  157.                   5. Little Command Interpreter (LCI)
  158.                   ===================================
  159.  
  160. Als kleines Extra ist in der GFASHELL ein kleiner Kommandointerpreter 
  161. eingebaut der die wichtigsten Befehle für ein sinnvolles Arbeiten 
  162. beherrscht.
  163.  
  164.                         Syntax der Beschreibung:
  165.                         ========================
  166.  
  167. KOMMANDO PARAMETER PARAMETER
  168.  
  169. in Klammern () => kann zusätzlich zum Kommando eingegeben werden
  170. [nnnn]         => kann optional benutzt werden 
  171. filespec       => [Laufwerk:][\ORDNER...\]DATEINAME.EXTENSION
  172.  
  173.  
  174.  
  175. CD [filespec]
  176.          Wechselt das Verzeichniss
  177.          Beispiel CD A:\GFA\      geht nach A:\GFA\
  178.                   CD              wechselt in das Verzeichniss das mit
  179.                                   SET PATH definiert wurde
  180.  
  181. CLS
  182.          löscht den Bildschirm
  183.  
  184. DEL(ETE) filespec(ohne Wildcards)
  185.          löscht angegebene Datei
  186.          Beispiel: DEL TEST.O löscht die Datei TEST.O
  187.  
  188. DFREE laufwerk
  189.          zeigt den freien Speicherplatz auf dem angegeben Laufwerk
  190.  
  191. DIR [filespec] [filespec]
  192.          Inhaltsverzeichnis von 1.Parameter auf 2.Parameter
  193.          Beispiel: DIR gibt alle Dateien des aktuellen Ordners aus
  194.                    DIR A:\TEST\*.GFA zeigt alle *.GFA-Files auf A:\TEST
  195.                    DIR *.* LST: Druckt den Inhalt des aktuellen Ordners
  196.  
  197. EXIT oder QUIT
  198.          Zurück zur SHELL. Kann auch mit QUIT oder durch drücken von 
  199.          "UNDO" erreicht werden.
  200.  
  201. FREE
  202.          Zeigt den freien Speicher an
  203.  
  204. HELP
  205.          Zeigt die bekannten Kommandos an
  206.  
  207. MKDIR filespec   
  208.          Erzeugt einen Ordner
  209.  
  210. PRINT filespec
  211.          Gibt die angegebene Datei auf den Drucker aus
  212.  
  213. REN(AME) filespec filespec
  214.          Verändert 1.Dateinamen in 2.Dateinamen. Geht nur auf aktuellen
  215.          Laufwerk.
  216.          Beispiel: RENAME TEST.O \GFA_3\HUGO.O
  217.  
  218. RMDIR filespec
  219.          Löscht einen Ordner
  220.  
  221. SET parameter parameter
  222.          setzt verschiedene Werte
  223.  
  224.     SET DATE datum
  225.          Bei gültiger Datumsangabe wird das Systemdatum geändert
  226.     SET TIME zeit
  227.          Bei gültiger Zeitangabe wird die Systemzeit geändert
  228.     SET PATH pfad
  229.          Verändert den Standardsuchpfad der GFASHELL
  230.     SET PROMPT string
  231.          Verändert das Eingabezeichen (Maximal 6 Stellen)
  232.  
  233. SH(OW) parameter 
  234.          zeigt verschiedene Werte
  235.  
  236.     SHOW GFA(SHELL)
  237.          zeigt die aktuellen GFASHELL Parameter
  238.     SHOW DATE
  239.          zeigt das Systemdatum
  240.     SHOW DIR
  241.          zeigt das aktuelle Verzeichniss
  242.     SHOW TIME
  243.          zeigt die Systemzeit
  244.     SHOW PATH
  245.          zeigt den aktuellen GFA-SHELL Pfad
  246.     SHOW MEMORY [SYSTEM]
  247.          zeigt den freien Speicher an
  248.     SHOW MEMORY INTERN
  249.          zeigt den freien Speicher der GFASHELL an
  250.  
  251. TYPE filespec
  252.          gibt die angegebene Datei auf dem Bildschirm aus
  253.  
  254. PURGE
  255.          löscht alle *.BAK Dateien im aktuellen Verzeichniss
  256.  
  257. Programme werden durch Eingabe des Pfades und des Dateinamens (ohne 
  258. Extension) gestartet. LCI überprüft ob ein ausführbares Programm mit 
  259. diesen Angaben besteht. Bzw.: ohne Pfadangabe wird geprüft ob ein 
  260. Programm im Ordner \BIN oder om definierten Pfad (mit SET PATH) mit 
  261. diesen Angaben existiert. LCI merkt sich die letzten 10 Eingaben (auch 
  262. nach verlassen von COMMAND). Diese können durch die Pfeiltasten UP und 
  263. DOWN wieder aufgerufen und editiert werden.
  264.  
  265.  
  266.                             6. Publik-Domain
  267.                             ================  
  268.  
  269. Nicht vergessen darf ich natürlich den Hinweis auf mein armes Konto:  
  270. Das Programm ist als Publik Domain Software freigegeben, d.H. dieses 
  271. Programm darf frei kopiert und weitergegeben werden. Dabei müssen die 
  272. Dateien GFASHELL.PRG, GFASHELL.INF, README.TXT und README.DOC mit 
  273. kopiert werden.  
  274.  
  275. Um aber wenigstens einen Teil meiner Unkosten für Kaffee und Zigaretten, 
  276. die bei der Erstellung dieses Programmes verbraucht wurden, wieder 
  277. zurückzubekommen, bitte ich jeden der dieses Programm gebrauchen kann, 
  278. mir einen  kleineren (oder auch etwas größeren) Betrag zu Überweisen.  
  279.  
  280. Ab 20,00 DM wird man registrierter Besitzer. (Registrierte Besitzer 
  281. erhalten von mir automatisch das nächste Update zugesandt, und bekommen 
  282. vom mir bei Bedarf eine individuelle Beratung.)
  283.  
  284. Ansonsten bin ich für Anregungen, Verbesserungsvorschläge, Lob und auch 
  285. Beschimpfungen immer zu haben. Ein kurzer Brief an mich genügt. Antwort 
  286. gibt es garantiert. 
  287.  
  288. Evntl. Fehlermeldungen bitte mit genauer Beschreibung des Fehlers (s. 
  289. Anlage) und der Versionsnummer des Programms an mich senden. Ich 
  290. benötige dazu eine Diskette mit: a) der GFASHELL.INF und b) evntl. dem 
  291. gerade bearbeiteten Files *.GFA *.O ... . Die Diskette gibt es 
  292. garantiert wieder zurück (natürlich mit der neusten GFASHELL Version).
  293.  
  294. Ralf Lenz  
  295. Gluckensteinweg 71  
  296. 6380 Bad Homburg   
  297.  
  298. Konto: 17837228  BLZ: 500 520 09  Kreissparkasse Bad Homburg   
  299.  
  300. P.S. Den Service mit den Fehlermeldungen gibt es natürlich nur für 
  301. registrierte Besitzer der GFASHELL. Ansonsten hilft nur warten auf die 
  302. nächste Version die in der PD-Scene kursiert.
  303.  
  304. P.P.S. Fanpost, Drohbriefe und Anregungen darf mir auch jeder andere 
  305. zusenden.
  306.  
  307.  
  308.  
  309.                              FEHLERMELDUNG
  310.                              =============
  311.  
  312. Adresse  Name:
  313.          Straße:
  314.          PLZ, Ort:
  315.          Tel.:
  316.  
  317.  
  318. Beim Benutzen von der GFASHELL V1.0 ist folgender Fehler aufgetreten:
  319.  
  320. (Bitte hier den Fehler genau beschreiben, evntl. Blatt anfügen.)
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337. ------------------------------------------------------------------------
  338.  
  339. Der Fehler ist     [] reproduzierbar
  340.                    [] nicht reproduzierbar
  341.  
  342. Der Fehler trat auf im  [] Diskettenbetrieb
  343.                            Typ der Floppy:______________  
  344.  
  345.                         [] Festplattenbetrieb
  346.                            Typ der Festplatte: ________________
  347.                            Treiber: ___________________________
  348.                            TURBODOS geladen       [] Ja [] Nein
  349.                            CACHE-Programm geladen [] Ja [] Nein                            
  350.                            (wenn ja, welches?: ________________)
  351.  
  352.                         [] RAM-Diskbetrieb
  353.                            Name des RAMDISK-Programms:________________
  354.     
  355. Ich besitze folgende Konfiguration:
  356.  
  357. TOS-Version:____________  [] im ROM    [] auf Diskette
  358.  
  359. ST-Typ  [] 520ST  [] 520ST+   [] 260 ST      [] 520STM 
  360.         [] 1040ST [] 1040STM  [] Mega ST 2   [] Mega ST 4
  361.         [] anderen:__________________________
  362.  
  363. bei Druckerfehlern:
  364.  
  365.         Druckertyp: __________________
  366.  
  367.         Spooler geladen [] Ja  [] Nein
  368.         wenn ja, welcher?: ____________________
  369.  
  370.         Schnittstelle: [] Seriell  [] Parallel
  371.  
  372. Mein GFA-Basic Interpreter hat die Versionsnummer 3.__
  373. Mein GFA-Basic Compiler hat die Versionsnummer: 3.__
  374.  
  375.  
  376.